Repository navigation
Free plan: today's data needs Build after an account's first 30 days - #32
Open
0xFantomMenace wants to merge 1 commit into
Open
0xFantomMenace wants to merge 1 commit into
0xFantomMenace wants to merge 1 commit into
Conversation
From November 23, 2026, after an account's first 30 days, Free data runs through yesterday (UTC). A Free REST request whose window reaches into today is refused before it is metered with HTTP 403 forbidden, which the SDK raises as PlanRequiredError with details["reason"] == "today_needs_build" and details["data_ends_on"]. Live subscribes, and replays that reach into today, are answered with forbidden; replays of past days stay on Free. - README: a Free Plan section, the Quick Start and REST reference windows, the Web3 plan paragraph, live Lighter and mempool notes, the WebSocket intro, and Error Handling no longer say that every plan reads today's data or streams live. - Docstrings for ErrorCode, PlanRequiredError and WsError describe the new refusal. - A test pins how the refusal body is surfaced.
0xFantomMenace
requested review from
bitmegistus and
nuttykenzo
as code owners
November 20, 2026 23:45
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Merge on 2026-11-23 when the change takes effect.
From November 23, 2026, after an account's first 30 days (counted from sign-up), Free data runs through yesterday (UTC): today's data and live streams need Build, and replays of past days stay on Free. Free keeps 50,000 credits a month, its rolling 30-day history window, the 30-day span per request or replay, and every route. Build and above are unaffected.
A Free REST request whose window reaches into today (an
end, ortimestampon a point-in-time route, at or after 00:00 UTC today, a range withoutend, or anycurrent,recentor summary route) is refused before it is metered with HTTP 403forbidden. The body names the plans that serve today, so the SDK already raises it asPlanRequiredError:datatypeisNone,required_plansis["build", "pro", "scale", "enterprise"],upgrade_urlis set, anddetailscarriesreason("today_needs_build") anddata_ends_on(the last day served). No SDK code change is needed.Changes
nowwindows no longer claim every plan can reach them, with the line to use on Free.ErrorCode,PlanRequiredErrorandWsError.PlanRequiredError,datatype is None,details["reason"],details["data_ends_on"]).Checks
pytest: 600 passed, 17 skipped.ruff checkon the changed files: no new findings.